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REPRESENTING A SERVICE DISCOVERY 
STREAM AS AN N-ARY TREE 

5 RELATED APPLICATIONS 

This application is a continuation in part of U.S. Patent Application No. 
09/557,947 filed April 24, 2000. 

10 TECHNICAL FIELD 

This invention relates generally to communication between electronic devices and, 

more particularly, relates to methods to discover services provided by server applications. 

BACKGROUND OF THE INVENTION 

15 

There are a significant number of wireless technologies in the marketplace today. 
The emerging standard for short range wireless technology is called Bluetooth. Bluetooth 
is a Radio Frequency (RF) specification for short-range, point-to-multipoint voice and 
data transfer. Bluetooth can transmit through solid, non-metal objects and its nominal 

2 0 link range is from 10 cm to 10 m, but can be extended to 100 m by increasing the 

transmit power. It is based on a low-cost, short-range radio link, and facilitates ad hoc 
connections for stationary and mobile communication environments. The Bluetooth 
wireless technology allows users to make connections between communication devices 
such as mobile phones and desktop and notebook computers. Finding and making use of 

2 5 services in these environments is becoming increasingly important due to the continued 
growth in wireless technologies as seen by the proliferation of mobile computing devices 
and also to the merging of wireless technologies and computer technologies. These 
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services can include basic services such as printing, faxing, paging, etc., more complex 
services such as video conferencing and teleconferencing, and any other type of service 
that a service provider may provide. Bluetooth utilizes a Service Discovery Protocol to 
allow communication devices to find and make use of these services. 
5 A service discovery stream consists of a linear stream of data that has data 

structures encoded within it to represent an available service on an enabled device. There 
are eight types of data encoded within a service discovery stream. These types are nil 
(null type), unsigned integer, signed twos-complement integer, universally unique 
identifier (UUID), text string, Boolean, data element sequence, data element alternative, 
1 0 and uniform resource locater (URL). A data element sequence is a data element whose 
data field is a sequence of data elements. A data element alternative is a data element 
whose data field is a sequence of data elements from which one data element is to be 
selected. 

Each element in the service discovery stream has a size attribute which describes 
1 5 the byte size of its content. A sequence or alternative element may have children 

elements within it. Since the terminating elements are embedded in the outer elements, 
the service discovery stream must be constructed from the bottom up. 

There are several issues that arise with service discovery streams. Creating a well 
formed service discovery stream is not straightforward. Traversing a service discovery 
2 0 stream in a simple manner is not easy because a large amount of descriptive data must be 
maintained due to the embedded data structures contained in the service discovery 
stream. These embedded data structures may also have structures embedded in them ad 
infinitum. Additionally, modifying a service discovery stream can be complex and 
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introduce errors. The modification, whether it be adding, changing, or removing a data 
structure, may alter bytes before, after, and at the point of modification, thereby 
increasing the likelihood of error. What is needed is a way to represent a service 
discovery stream that reduces the complexity of traversing the stream and that makes 
5 modifications to the stream easier to implement. 



SUMMARY OF THE INVENTION 

In view of the above problems, the service discovery stream is represented as an 
N-ary tree. By representing the service discovery stream as an N-ary tree, each element 

1 0 does not need to know the size of all of its children elements until the N-ary tree is 

converted into a service discovery stream. This allows for the quick construction of a 
well formed service discovery stream. The process is centered on grouping the data 
together and not how the data is actually represented in the service discovery stream. 
Traversing an N-ary tree is also a much simpler task. Very little information needs to be 

1 5 maintained during the traversal. Modifying a node in an N-ary tree is a trivial task. Since 
the tree is a non linear structure, any of the three types of modifications (changing, 
adding, or removing) requires only one modification to the entire tree. 

The content of the service discovery stream is traversed linearly to ensure it is 
well formed and the number of data elements contained in the service discovery stream is 

2 0 counted. The number of nodes in the N-ary tree is determined based upon the number of 
data elements. A list head is initialized. An element from the service discovery stream is 
obtained and a node is initialized with the element and information about the element. If 
the node is a leaf node, the node is added to the list head and the next element from the 
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service discovery stream is obtained. If the node is a parent node, the node is added to 
the list and the element is checked to see if there are any children. If there are children, 
the children are listed in the list head of the parent node. The next element is obtained 
from the service discovery stream and a node is initialized with the next element. The 
5 process is repeated until all elements in the service discovery stream have been converted. 
Additional features and advantages of the invention will be made apparent from 
the following detailed description of illustrative embodiments which proceeds with 
reference to the accompanying figures. 



10 BRIEF DESCRIPTION OF THE DRAWINGS 

While the appended claims set forth the features of the present invention with 
particularity, the invention, together with its objects and advantages, may be best 
understood from the following detailed description taken in conjunction with the 
accompanying drawings of which: 
15 Figure 1 is a block diagram generally illustrating an exemplary computer system 

on which the present invention resides; 

Figure 2 is a flowchart illustrating how a service discovery stream is converted 
into an N-ary tree using a sentinel head; 

Figure 3 is a flowchart illustrating how a service discovery stream is converted 
2 0 using a node; 

Figure 4 is a flowchart illustrating how a service discovery stream is recursively 
converted into an N-ary tree; and 

Figure 5 shows an illustrative example of an N-ary tree. 
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DETAILED DESCRIPTION OF THE INVENTION 

Turning to the drawings, wherein like reference numerals refer to like elements, 
the invention is illustrated as being implemented in a suitable computing environment. 
5 Although not required, the invention will be described in the general context of computer- 
executable instructions, such as program modules, being executed by a personal 
computer. Generally, program modules include routines, programs, objects, components, 
data structures, etc. that perform particular tasks or implement particular abstract data 
types. Moreover, those skilled in the art will appreciate that the invention may be 

1 0 practiced with other computer system configurations, including hand-held devices, multi- 
processor systems, microprocessor based or programmable consumer electronics, 
network PCs, minicomputers, mainframe computers, and the like. The invention may 
also be practiced in distributed computing environments where tasks are performed by 
remote processing devices that are linked through a communications network. In a 

1 5 distributed computing environment, program modules may be located in both local and 
remote memory storage devices. 

With reference to Fig. 1, an exemplary system for implementing the invention 
includes a general purpose computing device in the form of a conventional personal 
computer 20, including a processing unit 21, a system memory 22, and a system bus 23 

2 0 that couples various system components including the system memory to the processing 
unit 21. The system bus 23 may be any of several types of bus structures including a 
memory bus or memory controller, a peripheral bus, and a local bus using any of a variety 
of bus architectures. The system memory includes read only memory (ROM) 24 and 



6 

random access memory (RAM) 25. A basic input/output system (BIOS) 26, containing 
the basic routines that help to transfer information between elements within the personal 
computer 20, such as during start-up, is stored in ROM 24. The personal computer 20 
further includes a hard disk drive 27 for reading from and writing to a hard disk, not 
5 shown, a magnetic disk drive 28 for reading from or writing to a removable magnetic disk 
29, and an optical disk drive 30 for reading from or writing to a removable optical disk 3 1 
such as a CD ROM or other optical media. 

The hard disk drive 27, magnetic disk drive 28, and optical disk drive 30 are 
connected to the system bus 23 by a hard disk drive interface 32, a magnetic disk drive 

10 interface 33, and an optical disk drive interface 34, respectively. The drives and their 
associated computer-readable media provide nonvolatile storage of computer readable 
instructions, data structures, program modules and other data for the personal computer 
20. Although the exemplary environment described herein employs a hard disk, a 
removable magnetic disk 29, and a removable optical disk 3 1 , it will be appreciated by 

1 5 those skilled in the art that other types of computer readable media which can store data 
that is accessible by a computer, such as magnetic cassettes, flash memory cards, digital 
video disks, Bernoulli cartridges, random access memories, read only memories, and the 
like may also be used in the exemplary operating environment. 

A number of program modules may be stored on the hard disk, magnetic disk 29, 

2 0 optical disk 3 1 , ROM 24 or RAM 25, including an operating system 35, one or more 
applications programs 36, other program modules 37, and program data 38. A user may 
enter commands and information into the personal computer 20 through input devices 
such as a keyboard 40 and a pointing device 42. Other input devices (not shown) may 



include a microphone, joystick, game pad, satellite dish, scanner, or the like. These and 
other input devices are often connected to the processing unit 21 through a serial port 
interface 46 that is coupled to the system bus, but may be connected by other interfaces, 
such as a parallel port, game port or a universal serial bus (USB). A monitor 47 or other 
type of display device is also connected to the system bus 23 via an interface, such as a 
video adapter 48. In addition to the monitor, personal computers typically include other 
peripheral output devices, not shown, such as speakers and printers. 

The personal computer 20 may operate in a networked environment using logical 
connections to one or more remote computers, such as a remote computer 49. The 
remote computer 49 may be another personal computer, a server, a router, a network PC, 
a peer device or other common network node, and typically includes many or all of the 
elements described above relative to the personal computer 20, although only a memory 
storage device 50 has been illustrated in Fig. 1. The logical connections depicted in Fig. 
1 include a local area network (LAN) 5 1 and a wide area network (WAN) 52. Such 
networking environments are commonplace in offices, enterprise-wide computer 
networks, intranets and the Internet. 

When used in a LAN networking environment, the personal computer 20 is 
connected to the local network 51 through a network interface or adapter 53. When used 
in a WAN networking environment, the person computer 20 typically includes a modem 
54 or other means for establishing communications over the WAN 52. The modem 54, 
which may be internal or external, is connected to the system bus 23 via the serial port 
interface 46. In a networked environment, program modules depicted relative to the 
personal computer 20, or portions thereof, may be stored in the remote memory storage 
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device. It will be appreciated that the network connections shown are exemplary and 
other means of establishing a communications link between the computers may be used. 

In the description that follows, the invention will be described with reference to 
acts and symbolic representations of operations that are performed by one or more 
5 computer, unless indicated otherwise. As such, it will be understood that such acts and 
operations, which are at times referred to as being computer-executed, include the 
manipulation by the processing unit of the computer of electrical signals representing data 
in a structured form. This manipulation transforms the data or maintains it at locations in 
the memory system of the computer, which reconfigures or otherwise alters the operation 

10 of the computer in a manner well understood by those skilled in the art. The data 
structures where data is maintained are physical locations of the memory that have 
particular properties defined by the format of the data. However, while the invention is 
being described in the foregoing context, it is not meant to be limiting as those of skill in 
the art will appreciate that various of the acts and operation described hereinafter may 

1 5 also be implemented in hardware. 

When converting a service discovery stream into an N-ary tree, each data type is 
classified as either a leaf node or a parent node. A leaf node is defined as a node which 
can contain no children and a parent node is defined as a node that can potentially have 
children. The types of data that are leaf node types are Nil, Unsigned integer, Signed 

2 0 integer, UUID (universally unique identifier), Text string, Boolean, and URL (uniform 
resource locator). The types of data that are parent node types are Data element sequence 
and Data element alternative. By definition, each node in the tree, including the root 
node, can have N siblings, where N is any number. The siblings are connected to each 
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other using a doubly linked list. A doubly linked list is a series of nodes in which each 
node refers to both the next node and the preceding node, thereby forming two-way 
references. A doubly linked list can be traversed both forward and backward. 
Conversely, a singly linked list can only be traversed forward. 



before it is converted into an N-ary tree. In the first step, the content of the service 
discovery stream is validated by traversing the stream linearly to make sure it is well 
formed. If the service discovery stream is not well formed, an error is returned and the 
service discovery stream is not converted into an N-ary tree. In the second step, the 

1 0 number of elements contained in the service discovery stream is counted. 

Turning now to figure 2, the steps taken to convert a service discovery stream will 
be described when the service discovery stream has a sentinel node. A sentinel node is a 
node that contains no data and its purpose is to demarcate the terminal node. In the 
description that follows, the term "container" refers to either an alternative element or a 

1 5 sequence element. An array of SD_NODEs is created (step 100). The number of nodes 
in the array is set to the number of required nodes plus one. The number of required 
nodes is based upon the number of elements in the stream. A node is defined as: 
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Once a service discovery stream has been acquired, two steps are performed 



Struct SD_NODE_HEADER{ 



20 



UCHAR Type; 
UCHAR SpecificType; 



// contains the element type 
// contains specific element type (i.e, a 4 
byte integer) 



LIST JIEAD Link; 



} 



25 



struct SD NODE { 

SD_NODE_HEADER hdr; 
union { 

// all of the different data types defined 
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// . . . etc. . . 
// sequence 

5 SD_NODE_HEADER sequenceHdr; 

// alternative 

SDNODEHEADER altemativeHdr; 

10 } 

where sequenceHdr and altemativeHdr are list heads. A list head in its simplest form is 
the beginning of the list. An SD_NODE from the stream is acquired and initialized as the 
list head (step 102). A stack is created (step 104) and the list head is set to the first 
SD_NODE's sibling list pointer (step 106). The data type and data size is retrieved from 

1 5 the stream (step 108) and the current node is initialized with the data type, the data size, 
and the stream data (step 1 10). The current node is checked to see if it is a leaf node or a 
parent node (step 1 12). 

If the current node is a parent node, the size of the node's content is determined 
and checked to see if it is equal to zero (step 122). If the content is non-zero, the service 

2 0 discovery stream is incremented to the beginning of the next element of the service 

discovery stream (step 124). The current list head, current node, and service discovery 
stream size is pushed into the stack (step 126) and the current node is added to the tail of 
the list head (step 128). The list head is set to the current node's container list head (step 
130) and the service discovery stream size is set to the size of the container's stream size 

2 5 (step 132). The next node is obtained from the list (step 134) and steps 108-1 12 are 
repeated for the service discovery stream. If the content is zero, the stream size is 
checked to determine if it is zero (step 136). 
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If the current node is a leaf node, the current node is added to the tail of the tail of 
the list head (step 114) and the service discovery stream is adjusted beyond the data 
element (step 116). The stream size is decremented by the size of the element (step 118) 
and the next node is obtained from the list (step 120). The stream size is then checked to 
5 determine if it is zero (step 136). 

If the stream size is not zero, the process for the next node is started by repeating 
steps 108 to 136. If the stream size is zero, the stack is checked to see if it is empty (step 
138). If the stack is empty, the conversion is completed (step 140). If the stack is not 
empty, a list head, node, and stream size is popped from the stack (step 142) and the 
1 0 popped node's children pointer is set to the current list head (step 144). The stream size is 
set to the popped stream size minus the popped node's size (step 146) and the list head is 
set to the popped list head (step 148). The stream size is checked to determine if it is zero 
(step 136) and the process of steps 108-148 is repeated until the stack is empty. 

Turning now to figure 3, the steps taken to convert a service discovery stream will 
15 be described when the service discovery does not have a sentinel node. Note that these 
steps can also be used if the service discovery stream has a sentinel node. A stack is 
created (step 200) and an array of SD NODEs is created (step 202). The number of nodes 
is based upon the number of elements in the stream The node is defined as: 
struct SD_NODE { 

2 o UCHAR Type; // contains the element type 

UCHAR SpecificType; // contains specific element type (i.e, a 4 

byte integer) 
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ULONG DataSize; // size of the element's data 
union { 

// all of the different data types defined 

}u; 
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LIST_ENTRY Link; // link to next and previous siblings 

} 

The current service discovery stream size is stored (step 204) and the list head is 
set to the service discovery stream's first SDNODEs sibling list pointer (step 206). The 
data type and data size is retrieved from the service discovery stream (step 208) and the 
current node is initialized with the data type, the data size, and the service discovery 
stream data (step 210). The current node is checked to see if it is a leaf node or a parent 
node (step 212). 

If the current node is a parent node, the size of the node's content is determined 
and checked to see if it is equal to zero (step 222). If the content is non-zero, the service 
discovery stream is incremented to the beginning of the next element of the service 
discovery stream (step 224). The current node is added to the list head (step 226), and the 
current list head, node, and stream size is pushed into the stack (step 228). The next node 
from the service discovery stream is obtained (step 230) and the list head is set to the next 
node's sibling list pointer (step 232). The stream size is set to the size of the parent node 
content size (step 234) and steps 208-212 are repeated for the next node. If the content is 
zero, the stream size is checked to determine if it is zero (step 236). 

If the current node is a leaf node, the current node is added to the list head (step 
214) and the service discovery stream is adjusted beyond the data element (step 216). 
The stream size is decremented by the size of the element (step 218) and the next node is 
obtained (step 220). The stream size is then checked to determine if it is zero (step 236). 

If the stream size is not zero, the process for the next node is started by repeating 
steps 208 to 236. If the stream size is zero, the stack is checked to see if it is empty (step 
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238). If the stack is empty, the conversion is completed (step 240). If the stack is not 
empty, a list head, node, and stream size is popped from the stack (step 242) and the 
popped node's children pointer is set to the current list head (step 244). The stream size is 
set to the popped stream size minus the popped node's size (step 246) and the list head is 
5 set to the popped list head (step 248). The stream size is checked to determine if it is zero 
(step 236) and the process of steps 208-248 are repeated until the stack is empty. 

Turning now to Figure 4, the steps taken to convert a service discovery stream to 
an N-ary tree will be described using a recursive method. These steps can be used for any 
valid service discovery stream. An array of SD JSfODEs is created (step 300). The 
1 0 number of nodes in the array is set to one more than the number of required nodes. The 
number of required nodes is based upon the number of elements in the stream. A node is 
defined as: 



Struct SD_NODE_HEADER{ 
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UCHAR Type; 
UCHAR SpecificType; 



// contains the element type 
// contains specific element type (i.e, a 4 
byte integer) 



LISTHEAD Link; 



20 



struct SD NODE { 

SDNODEHEADER hdr; 
union { 

// all of the different data types defined 
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// . . . etc. . . 



// sequence 

SD_NODE_HEADER sequenceHdr; 



30 



// alternative 

SD_NODE_HEADER alteraativeHdr; 



}u; 
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where sequenceHdr and alternativeHdr are list heads. The list head is set to the first 
SDJSfODE's sibling list pointer (step 302) and the next node is obtained (step 304). A 
parsing function is called passing a reference to the list head, the node list, the service 
discovery stream, and the stream size (step 306). The stream size is checked to determine 
5 if it is zero (step 308). If the stream size is zero, the process ends (step 3 1 0). 

If the stream size is not zero, the data type and data size is retrieved from the 
service discovery stream (step 312) and the current SD_NODE is initialized with the data 
type, data size, and the stream data (step 314). The current node is checked to see if it is a 
leaf node or a parent node (step 3 1 6). 

10 If the current node is a parent node, the service discovery stream is incremented to 

the beginning of the next element of the service discovery stream (step 326). The current 
node is added to the list head (step 328) and the stream size is set to the size of the 
container's stream size (step 330). The next node is obtained from the list (step 332) and 
steps 308-316 are repeated for the next node. 

15 If the current node is a leaf node, the current node is added to the list head (step 

318) and the service discovery stream is adjusted to beyond the element (step 320). The 
stream size is decremented by the size of the element (step 322) and the next node is 
obtained from the list (step 324). The process outlined in steps 308 to 334 is then 
repeated until a stream size of zero is detected, at which time the process ends. 

2 0 Figure 5 illustrates an exemplary N-ary tree for a service discovery stream 

obtained from following the steps outlined in any of the embodiments described above. 
For purposes of illustration, the service discovery stream contains a sequence which 
contains an 8 bit unsigned integer of 4 and another sequence which contains two 8 bit 
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unsigned integers of 10 and 20. The service discovery stream would look like 
0x350808043504080a0814 (hex). In Figure 5, a line with a single arrow indicates a 
single link between elements and a line with two arrows indicates a double link between 
elements. The first sequence 460 of the N-ary tree is linked to the unsigned integer of 4 
5 (UINT (4)) 462. The UINT 462 is doubly linked to sequence 464 which is linked to 

UINT(IO) 466, the unsigned integer of 10 and UINT(20) 468, the unsigned integer of 20. 
It should be noted that the data size is not required for the N-ary tree. 

An addition of a sequence to the N-ary tree or the addition of a data structure to a 
sequence of the N-ary tree would simply require the sequence or data structure to be 

1 0 added to be inserted into the tree at the appropriate location and linked to the adjacent 
data structure/sequence of the tree. Removing a data structure or sequence merely 
requires the data structure or sequence to be removed to be taken out of the tree and 
linking the data structures/sequences that were linked to the removed data structure or 
sequence to each other. Similarly, all that is needed to change a sequence or data 

1 5 structure is to combine the steps of adding and removing a sequence or data structure. 
Note that adding, removing, or changing a sequence or data structure only requires one 
modification to the tree. Conversely, modification of a service discovery stream may 
alter bytes before, after, and at the point of modification. 

Constructing a service discovery stream from an N-ary tree is straightforward. 

2 0 The service discovery stream must be constructed from the bottom up. Beginning at the 
bottom of the N-ary tree, the sequences and their elements are converted one sequence at 
a time. The conversion requires that the data element size and the data element type be 
included with the element in a linear stream of data. After the first sequence and its 



elements have been converted, the next sequence is converted and placed in front of the 
linear stream of data representing the first sequence. The conversion is repeated until all 
sequences are converted, which results in the service discovery stream. 

Representing a service discovery stream as an N-ary tree has been described. The 
ease of which the N-ary tree can be modified has been described. This likelihood of error 
is reduced since only one modification to the tree is required when a change, addition, or 
removal of a data structure or sequence is made. The data size of a data structure does 
not need to be known until the tree is converted into a service discovery stream. 

All of the references cited herein, including patent applications are hereby 
incorporated in their entireties by reference. In view of the many possible embodiments 
to which the principles of this invention may be applied, it should be recognized that the 
embodiment described herein with respect to the drawing figures is meant to be 
illustrative only and should not be taken as limiting the scope of invention. For example, 
those of skill in the art will recognize that the elements of the illustrated embodiment 
shown in software may be implemented in hardware and vice versa or that the illustrated 
embodiment can be modified in arrangement and detail without departing from the spirit 
of the invention. Therefore, the invention as described herein contemplates all such 
embodiments as may come within the scope of the following claims and equivalents 
thereof. 



17 

CLAIMS 

We claim: 

1 . A computer-readable medium having computer-executable instructions for 
performing steps to convert a service discovery stream into an N-ary tree, the service 

5 discovery stream having a list of nodes, each node having a data element, a data type and 
a data size, the service discovery stream having a stream size, the steps comprising: 

a) retrieving the data type and the data size of one of the nodes; 

b) adding the node to a list head; 

c) performing one of decrementing the stream size by the data size and 
1 0 incrementing the stream to the beginning of a next data element; and 

d) obtaining a next node from the list of nodes. 

2. The computer-readable medium of claim 1 having further computer-executable 
instructions for performing the steps of: 

1 5 verifying the service discovery stream; 

determining the number of nodes in the list of nodes; 
creating a stack; and 

setting the list head to a sibling list pointer of the node. 

2 0 3. The computer-readable medium of claim 1 having further computer-executable 
instructions for performing the step of repeating steps a), b) and c) for the next node. 
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4. The computer-readable medium of claim 3 having further computer-executable 
instructions for performing the step of repeating steps a), b), c) and d) for each node in the 
list of nodes. 

5 5. The computer-readable medium of claim 1 having further computer-executable 
instructions for performing the step of determining if the node is a leaf node. 

6. The computer-readable medium of claim 5 having further computer-executable 
instructions for performing the steps of: 

10 if the node is a leaf node : 

adjusting the service discovery stream beyond the data element; 
determining if the stream size of the next node is zero; and 
wherein the step of performing one of decrementing the stream size by the 
element size and incrementing the service discovery stream to the beginning 
15 of the next node comprises the step of decrementing the stream size by the 

data size. 

7. The computer-readable medium of claim 5 having further computer-executable 
instructions for performing the steps of: 

20 if the node is not a leaf node: 

determining if the data size is zero; 

if the data size is not zero, the step of performing one of decrementing the 
stream size by the data size and incrementing the service discovery stream 
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to the beginning of a next node comprises the step of incrementing the 
service discovery stream to the beginning of the next node; and 
repeating steps a), b), c), and d). 



5 8. The computer-readable medium of claim 7 having further computer-executable 
instructions for performing the steps of: 
if the node is not a leaf node: 

pushing the list head, the node, and the stream size into a stack; and 
setting the list head to one of a sibling list pointer of the node and a 
1 o container list head; 

setting the stream size to one of a size of a parent node content size and a 
container stream size. 



9. The computer-readable medium of claim 1 having further computer-executable 
1 5 instructions for performing the steps of: 
if the stream size is zero; 

determining if the stack is empty; 
if the stack is not empty: 

obtaining a popped list head, the next node, and a popped stream 
2 0 size from the stack; 

setting a children pointer of the next node to the list head; 
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setting the stream size to a revised stream size, the revised stream 
size formed by substracting the data size of the next node from the 
popped stream size; and 

setting the list head to the popped list head. 



10. A method to convert a service discovery stream to an N-ary tree, the service 
discovery stream having a first number of elements, each element having an element type 
and an element size, the service discovery stream having a stream size, the steps 
comprising: 

setting a list head to a sibling list pointer of a first node; 

retrieving the element type and the element size of a first element from the 
service discovery stream; 

initializing the first node with the first element and the element type and the 
element size of the first element; 

determining if the first node is a leaf node; and 

if the first node is a leaf node: 

adding the first node to a tail of a list; 

adjusting the service discovery stream beyond the first element; 
decrementing the stream size by the element size of the first element; 

and 

obtaining a new node from a node listing. 



The method of claim 10 further comprising the steps of: 

creating an array of nodes having a number of nodes, the number of nodes 
equal to the first number of elements plus one; and 
creating a stack. 

The method of claim 1 1 further comprising the steps of: 
if the first node is a not a leaf node: 

determining if the element size of the first node is equal to zero; 
if the element size of the first node is not equal to zero: 

incrementing the service discovery stream to the beginning of a 
next element; 

pushing the first node, the stream size, and the list head into a 

stack; 

adding the first node to the tail of the list; 
setting the list head to a container list head of the first node; 
setting the stream size to a container stream size; and 
obtaining the new node from the node listing. 

The method of claim 12 further comprising the steps of: 
determining if the stream size equals zero; and 
if the stream size equals zero: 

determining if the stack is empty; 
if the stack is not empty: 

popping a new list head, the new node, and a new stream size from 
the stack; 



setting a children pointer of the new node to the list head; 
setting the stream size to the new stream size minus a size of the new 
node and; 

setting the list head to the new list head. 

The method of claim 13 further comprising the steps of: 
for each node: 

a) retrieving a new element type and a new element size of a new element 
from the service discovery stream; 

b) initializing the node with the new element and the new element type 
and the new element size of the new element; 

c) determining if the node is a leaf node; and 

d) if the node is a leaf node: 

adding the node to a tail of the list head; 
adjusting the service discovery stream beyond the new element; 
decrementing the stream size by the new element size of the new 
element; 

obtaining the new node from the node listing; 

e) if the node is a not a leaf node: 

determining if the new element size of the node is equal to zero; 
if the new element size of the node is not equal to zero: 

incrementing the service discovery stream to the beginning 
of the next element; 

pushing the node, the stream size, and the list head into the 
stack; 
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adding the node to the tail of the list; 

setting the list head to the container list head of the node; 

setting the stream size to the container stream size; 

obtaining the new node from the list. 
5 f) determining if the stream size equals zero; and 

g) if the stream size equals zero: 

determining if the stack is empty; 
if the stack is not empty; 

popping the new list head, the new node, and the new stream 
1 0 size from the stack; 

setting a children pointer of the new node to the list head; 
setting the stream size to the new stream size minus a size of 
the new node; 

setting the list head to the new list head; and 
15 if the stream size does not equal zero, repeating steps a) to g) for the new 

node. 

15. A method to convert a service discovery stream to an N-ary tree, the service 
discovery stream having a first number of elements, each element having an element type 
2 0 and an element size, the service discovery stream having a stream size, the steps 
comprising: 

setting a list head to a sibling list pointer of a first node; 

retrieving the element type and the element size of a first element from the 
service discovery stream; 
2 5 initializing the first node with the first element and the element type and the 

element size of the first element; 

determining if the first node is a leaf node; and 
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if the first node is a leaf node: 

adding the first node to the list head; 

adjusting the service discovery stream beyond the first element; 
decrementing the stream size by the element size of the first element; 

5 and 

obtaining a new node from a node listing. 



16. The method of claim 15 further comprising the steps of: 

creating an array of nodes having a number of nodes, the number of nodes 
1 0 equal to the first number of elements plus one; and 
creating a stack. 



17. The method of claim 16 further comprising the steps of: 
if the first node is a not a leaf node: 
1 5 determining if the element size of the first node is equal to zero; 

if the element size of the first node is not equal to zero: 

incrementing the service discovery stream to the beginning of a 
next element; 

pushing the first node, the stream size, and the list head into the 

2 0 stack; 

adding the first node to the list head; 

setting the stream size to a content size of a parent node; 

obtaining the new node from the node listing; and 



setting the list head to a sibling list pointer of the new node; 

The method of claim 17 further comprising the steps of: 
determining if the stream size equals zero; and 
if the stream size equals zero: 

determining if the stack is empty; 
if the stack is not empty: 

popping a new list head, the new node, and a new stream size from 
the stack; 

setting a children pointer of the new node to the list head; 
setting the stream size to the new stream size minus a size of the new 
node; and; 

setting the list head to the new list head. 

The method of claim 1 8 further comprising the steps of: 
for each node: 

a) retrieving a new element type and a new element size of a new element 
from the service discovery stream; 

b) initializing the node with the new element and the new element type 
and the new element size of the new element; 

c) determining if the node is a leaf node; and 

d) if the node is a leaf node: 

adding the node to the list head; 

adjusting the service discovery stream beyond the new element; 
decrementing the stream size by the new element size of the new 
element; 

obtaining the new node from the node listing; 
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e) if the node is a not a leaf node: 

determining if the new element size of the node is equal to zero; 
if the new element size of the node is not equal to zero: 

incrementing the service discovery stream to the beginning 
5 of the next element; 

pushing the node, the stream size, and the list head into the 
stack; 

adding the node to the list head; 
obtaining the new node from the node listing; 
1 0 setting the list head to the sibling list pointer of the new 

node; 

setting the stream size to the container stream size; 

f) determining if the stream size equals zero; and 

g) if the stream size equals zero: 

1 5 determining if the stack is empty; 

if the stack is not empty: 

popping the new list head, the new node, and the new 
stream size from the stack; 

setting a children pointer of the new node to the list 
2 0 head; 

setting the stream size to the new stream size minus a 
size of the new node; 

setting the list head to the new list head; and 
if the stream size does not equal zero, repeating steps a) to g) for the new 

2 5 node. 



A method to convert a service discovery stream to an N-ary tree comprising: 

a) receiving a reference to a list head, a node list, a stream, and a stream size; 

b) determining if the stream size is equal to zero; 

c) if the stream size is not equal to zero: 

retrieving a data type and a data size of a data element from the 
stream; 

initializing a node with the data type, the data size, and the data 
element; 

adding the node to the list head; 

performing one of adjusting the stream beyond the data element and 
incrementing the stream to the beginning of a next data element; 

performing one of decrementing the stream size by the data size and 
decrementing the stream size by a container size of a stream of a 
container; and 

obtaining a next node from the node list. 

The method of claim 20 further comprising the steps of: 
determining if the node is a leaf node; 

if the node is a leaf node, repeating steps a) to c) for the next node; and 
wherein the step of performing one of adjusting the stream beyond the data element 
and incrementing the stream to the beginning of the next data element comprises the 
step of adjusting the stream beyond the data element and the step of performing one 
of decrementing the stream size by the data size and decrementing the stream size 
by the container size of the stream of the container comprises the step of 
decrementing the stream size by the data size. 

The method of claim 20 further comprising the steps of: 
determining if the node is a leaf node; 
if the node is not a leaf node: 

calling a parsing function to receive a reference to the list head of the 
container, the node list, the stream, and the container size; 



28 

repeating steps a) to c) for the next node; and 
wherein the step of performing one of adjusting the stream beyond the data element 
and incrementing the stream to the beginning of the next data element comprises the 
step of incrementing the stream to the beginning of the next data element and the 
step of performing one of decrementing the stream size by the data size and 
decrementing the stream size by the container size of the stream of the container 
comprises the step of decrementing the stream size by the container size of the 
stream of the container. 

The method of claim 20 further comprising the steps of: 

creating an array of nodes having a number of nodes, the number of nodes 
equal to a number of data elements in the strean; 

setting the list head to a sibling list pointer of a first node; 

obtaining the next node; and 

calling a parsing function to receive a reference to the list head of the 
container, the node list, the stream, and the container size. 
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ABSTRACT OF THE INVENTION 

A. service discovery stream is represented as an N-ary tree that provides the 
5 capability to change, add, or remove an element with only one modification to the entire 
tree. The number of elements in a stream are counted and each element and the element's 
children are converted into a node of the N-ary tree. Each node in the tree can have any 
number of siblings, which are linked to each other using a doubly linked list. 
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